home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / bbs / redist27 / redist.sys < prev    next >
Text File  |  1994-08-28  |  9KB  |  192 lines
  1.                    REDIST - Message Re-distribution Server
  2.                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This REDIST software is designed to run using v5.15 or later of the F6FBB
  5. software.  It has been tested on the releases of version 5.15a, 5.15b and 5.15c
  6. and will almost certainly work with any of the version 5.14 and 5.15 releases.
  7. It is not designed to run with any other BBS software as it directly accesses
  8. the FBB initialisation file.
  9.  
  10. I have recently heard that Hank, W0RLI, is releasing a REDIST compatible server
  11. for use with his BBS.  Unfortunately this server does not (at the moment)
  12. update my master database, so it's not possible to know which W0RLI-type BBSs
  13. have installed the server. The only thing I know is that there are more BBSs
  14. supporting REDIST than I know about!
  15.  
  16. I hope that most FBB-type (and W0RLI-type) BBSs will install this server.  If
  17. it is widely installed it will hopefully become widely used.  If it is used
  18. correctly then it may help to reduce the number of 'ALL @ EU' and 'ALL @ WW'
  19. bulletins that are sent by people trying to address a small area of Europe or
  20. the world.    If it reduces the volume of such bulletins in even just a small way
  21. then it will have served it's purpose.
  22.  
  23. Setting up the software
  24. ~~~~~~~~~~~~~~~~~~~~~~~
  25.  
  26. 1) Copy REDIST.EXE into the \FBB\BIN directory. I have asssumed that \FBB\BIN
  27. is in your DOS PATH statement. The program will run from any directory in the
  28. DOS PATH, but the F6FBB software must be running in the \FBB directory for the
  29. software to find the INIT.SRV file.  I think this is a requirement of the
  30. F6FBB software anyway, so I don't think it will be a problem.
  31.  
  32. 2) Create a file called REDIST.CFG in the \FBB directory.  The file can have a
  33. number of lines and the format of each line is described below.
  34.  
  35. Each line in the config file begins with a string which defines the contents
  36. of the line.  The lines do not need to be in the sequence shown above and the
  37. software sensibly handles missing lines (I hope!). The meaning for each line
  38. is as follows :
  39.  
  40. LOCBBS=          The address to be used when a messages is addressed to
  41. LOCAL=             the LOCBBS, LOCAL, REGION or NATION servers.
  42. REGION=          LOCBBS can be used to re-direct bulletins to another
  43. NATION=          BBS if the host BBS is a specialist BBS with very few
  44.                  users.
  45.                  Each line can contain one or more @ field addresses. A
  46.                  copy of the bulletin will be sent to each address in the
  47.                  list.    Use commas to seperate the addresses.
  48.                  Lines must not be longer than 128 characters.
  49.  
  50. LOCBBS_DESC=     A line of text describing the LOCBBS, LOCAL, REGION
  51. LOCAL_DESC=      or NATION areas.
  52. REGION_DESC=     Descriptions must not be longer than 32 characters.
  53. NATION_DESC=
  54.  
  55. DEFAULT_TO=      Allows a default TO field to be specified.  Some
  56.                  areas do not permit messages to ALL and this allows
  57.                  the host BBS sysop to define what field should be used
  58.                  as a default if the user does not supply one in the subject
  59.                  line. The TO field should be a maximum of 6 characters.
  60.  
  61. MAIL_IN=         Forces the software to output the redistributed messages to
  62.                  the file named in this line.  This overrides the value
  63.                  obtained from the MAIL.IN setting in INIT.SRV.  This can be
  64.                  used to allow the messages to be further processed by other
  65.                  servers/software prior to being added to the real FBB MAIL.IN
  66.                  file.    This parameter will rarely need to be used.
  67.  
  68. MAIL_SYSOP=      New optional parameter in v2.04.
  69.                  This option allows the sysop to choose if he/she wants to be
  70.                  mailed each time the REDIST server is used.  This parameter
  71.                  can take values of Y/YES or N/NO.    If an incorrect value is
  72.                  entered or the line is not included in the config file then
  73.                  the software will default to sending the sysop a message.
  74.  
  75. An example REDIST.CFG is shown below :
  76.  
  77. -------Example REDIST.CFG--------------------------------------------------
  78.  
  79. LOCBBS=GB7FCI
  80. LOCBBS_DESC=Blackpool
  81. LOCAL=#NW,GB7LAN
  82. LOCAL_DESC=North West England
  83. REGION=#ZONEA
  84. REGION_DESC=Northern England
  85. NATION=GBR
  86. NATION_DESC=Great Britain
  87. DEFAULT_TO=INFO
  88. MAIL_IN=C:\MAIL\REDIST.MAI
  89. MAIL_SYSOP=Y
  90.  
  91. ---------------------------------------------------------------------------
  92.  
  93. If the following message was addressed to a BBS with the above REDIST.CFG
  94. file...
  95.  
  96. SP LOCAL @ GB7FCI
  97. A test message
  98.  
  99. Just a small test of the LOCAL server at GB7FCI.
  100.  
  101. Bye, Chris
  102. /EX
  103.  
  104. ...then copies of the message would be sent as bulletins to 'INFO @ #NW' and
  105. 'INFO @ GB7LAN' and placed in a file called C:\MAIL\REDIST.MAI.  A brief
  106. message would also be sent to the sysop informing her/him that the server has
  107. been activated.
  108.  
  109. The choice of bulletin group addresses is left up to the sysop, but please try
  110. to choose sensible addresses.  The LOCAL group is intended to cover small
  111. local areas, which may be just a few BBSs or perhaps an area of a few hundred
  112. square miles.  The REGION group is intended to cover regions of a country, in
  113. the UK the RSGB zones are probably appropriate and maybe US States might be a
  114. sensible size.    The NATION group is intended to cover an entire country.
  115.  
  116. If you want to ignore any of the LOCAL, REGION or NATION addresses, then just
  117. repeat the addresses for one of the other servers.    If you omit the definition
  118. for the LOCAL, REGION or NATION servers from the config file the LOCBBS server
  119. address will be used by default.  For example, if you don't have any address
  120. at your BBS that would be sensible as a REGION, then you might put something
  121. like this in REDIST.CFG file :
  122.  
  123. LOCAL=#NW
  124. REGION=#NW
  125. NATION=GBR
  126.  
  127. The addresses used in the REDIST.CFG file can be hierarchical addresses if
  128. required, but each one must be less than 32 characters long and the whole line
  129. must also be less than 128 characters.
  130.  
  131. 3) Edit INIT.SRV to include entries to call REDIST for LOCBBS, LOCAL, REGION
  132. and NATION messages.  Change the text describing the server as appropriate.
  133. The entries are the same as any other server, ie.
  134.  
  135. LOCBBS    REDIST           Readdress a message as a bulletin @ GB7FCI
  136. LOCAL    REDIST           Readdress a message as a #NW bulletin
  137. REGION    REDIST           Readdress a message as a #ZONEA bulletin
  138. NATION    REDIST           Readdress a message as a GBR bulletin
  139.  
  140. It is essential that the names used to call the server remain as LOCBBS,
  141. LOCAL, REGION and NATION.  The server uses these names to look up the
  142. details in REDIST.CFG and the program will fail if the incorrect names are
  143. used in INIT.SRV.
  144.  
  145. 4) Put a copy of the REDIST.USR and REDIST.BBS files in your BBS user files
  146. directories and also let your users know that the facility is available.  The
  147. more people who know about and use the facility the more widely it will spread.
  148. If it's used at a lot of BBSs then the choice of destinations will be far
  149. better.
  150.  
  151. 5) From the \FBB directory run REDIST from DOS with a parameter of /UPDATE, eg
  152.  
  153. C:\FBB> REDIST /UPDATE
  154.  
  155. This will send an update of your REDIST server details to me so that I can
  156. update my master database.
  157.  
  158. Comments
  159. ~~~~~~~~
  160.  
  161. 1) The server sends a message to REDIST @ GB7FCI.#16.GBR.EU when it is first
  162. used, when you use the /UPDATE parameter from DOS, when a new version of the
  163. software is installed and on its first run after any change to the REDIST.CFG
  164. file. This is controlled by a file created by the server called REDIST.###.
  165. Please allow this message to be forwarded to me as it allows me to maintain a
  166. database of BBSs supporting the server.  The message activates a server at my
  167. BBS which automatically updates the database of BBSs supporting the server.
  168. This database has been used to create the REDIST.BBS file found in this
  169. distribution set.
  170.  
  171. 2) The server creates a new forwarding header for the originating users BBS.
  172. This allows any replies to the distributed bulletin sent using the SR command
  173. to be directed to the correct user.  This will prevent any extra work on your
  174. behalf in re-addressing the replies.  I believe that the created header should
  175. be compatible with most BBS software.  Please advise me if you find any
  176. problems with the new header.
  177.  
  178. 3) If your entry in REDIST.BBS or any listings that I distribute is incorrect,
  179. you can run REDIST from DOS with the /UPDATE parameter to send an update to my
  180. BBS at any time.
  181.  
  182. If you find any errors or have problems with the software, please mail me.
  183. Also please let me know if you have any suggestions for improvements to the
  184. server.
  185.  
  186. (C) Copyright 1993 & 1994 Chris McMahon, G6FCI @ GB7FCI.
  187.  
  188. This software can be freely distributed for use by radio amateurs for
  189. non-commercial purposes.  This documentation may be included in articles or
  190. books produced for amateur radio purposes as long as the author is ackowledged.
  191.  
  192.